.Dd July 3, 2024
.Dt NQTAIL 1
.Os
.Sh NAME
.Nm nqtail
.Nd job queue log viewer
.Sh SYNOPSIS
.Nm
.Op Fl a
.Op Fl n
.Op Fl q
.Op Ar job\ id ...
.Sh DESCRIPTION
.Nm
is a simple utility for
.Dq following
the output of
.Xr nq 1
jobs.
.Pp
Without arguments, the output of the currently running and queued
as-of-now jobs is emitted; else the presented job ids are used.
.Pp
.Nm
automatically terminates after the corresponding jobs are done.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl a
Output all log files, even of already finished jobs.
.It Fl n
Don't wait for new output.
Can be used to look at enqueued commands.
.It Fl q
Only print the first line of each job output
(i.e. the
.Li exec
line).
.El
.Sh ENVIRONMENT
.Bl -hang -width Ds
.It Ev NQDIR
Directory where lock files/job output resides, see
.Xr nq 1 .
.El
.Sh EXIT STATUS
.Ex -std
.Sh INTERNALS
On Linux,
.Xr inotify 7
is used to monitor job output.
On FreeBSD and macOS,
.Xr kqueue 2
is used.
On other operating systems, polling is used.
.Sh SEE ALSO
.Xr nq 1 ,
.Xr nqterm 1
.Sh AUTHORS
.An Leah Neukirchen Aq Mt leah@vuxu.org
.Sh LICENSE
.Nm
is in the public domain.
.Pp
To the extent possible under law,
the creator of this work
has waived all copyright and related or
neighboring rights to this work.
.Pp
.Lk http://creativecommons.org/publicdomain/zero/1.0/
.\" .Sh BUGS
